官方脚本
本文介绍如何使用官方脚本在现有 Kubernetes 集群上安装或升级 Zadig，适用于企业正式环境。
# 资源准备
- Kubernetes 集群版本：v1.16+，推荐 8C16G，需管理员权限
- Helm 版本：v3.5.0 及以上
注意事项
- 如需使用内置存储组件（MySQL/MongoDB/MinIO），请提前配置 Kubernetes 默认 StorageClass 以支持 PVC 持久化
- 部分集群网络插件可能导致 Service 后端 Pod 无法自访问，请提前验证
- 配置 kube-dns 服务，确保服务和 Pod 可按名称寻址
# 安装
# 步骤 1：准备安装环境
- 需一台可连通集群的机器执行安装脚本
- 该机器需已安装 kubectl(opens new window)，并具备集群管理员权限
# 步骤 2：下载安装脚本
根据使用场景，选择不同的安装脚本，所有脚本安装的 Zadig 版本均相同，区别在于是否提供数据持久化存储的能力。
| 场景 | 下载源 | 说明 |
|---|---|---|
| 快速体验 | 官方下载(opens new window) GitHub(opens new window) | 不支持持久化，不推荐生产使用 |
| 生产使用 | 官方下载(opens new window) GitHub(opens new window) | 支持持久化，推荐生产环境 |
下载并赋予脚本执行权限：
# 快速体验
curl -LO https://github.com/koderover/zadig/releases/download/v3.4.1/install_quickstart.sh
chmod +x ./install_quickstart.sh
# 生产使用
curl -LO https://github.com/koderover/zadig/releases/download/v3.4.1/install.sh
chmod +x ./install.sh
1
2
3
4
5
6
7
2
3
4
5
6
7
提示
下表为安装脚本支持的环境变量，均有默认值。如需自定义，可在执行前设置。
# 配置 IP 访问地址示例
export IP=<node external ip>
export PORT=< 30000 - 32767 任一端口>
# 如果出现端口占用情况，换一个端口再尝试
1
2
3
4
2
3
4
| 变量名称 | 默认值 | 必填 | 说明 |
|---|---|---|---|
| NAMESPACE | zadig | 否 | Kubernetes 命名空间 |
| DOMAIN | 和 IP 二选一 | 访问 Zadig 的域名，仅生产脚本可用，需解析到 gateway-proxy | |
| IP | 和 DOMAIN 二选一 | 集群节点外网 IP，用于访问 Zadig | |
| PORT | 使用 IP 访问必填 | 合法 Kubernetes 端口（30000-32767） | |
| SERVICE_TYPE | NodePort | 否 | 网关服务类型：NodePort/LoadBalancer，默认 NodePort |
| STORAGE_SIZE | 20G | 否 | 内置数据库和对象存储的数据存储大小 |
| STORAGE_CLASS | 否 | 持久化存储卷类型，仅生产脚本可用 | |
| MONGO_URI | 否 | 外部 MongoDB 连接串，多个地址需转义，仅生产脚本可用 | |
| MONGO_DB | zadig | 否 | MongoDB 数据库名，仅生产脚本可用 |
| MYSQL_HOST | 否 | 外部 MySQL 主机，仅生产脚本可用 | |
| MYSQL_PORT | 否 | MySQL 端口，仅生产脚本可用 | |
| MYSQL_USERNAME | 否 | MySQL 用户名，仅生产脚本可用 | |
| MYSQL_PASSWORD | 否 | MySQL 密码，仅生产脚本可用 | |
| ENCRYPTION_KEY | 否 | 数据加密密钥，首次安装后请妥善保存，重装需设置相同值以解密历史数据 |
# 步骤 3：开始安装
# 快速体验
export IP=<IP>
export PORT=<合法端口>
./install_quickstart.sh
1
2
3
2
3
# 生产使用
建议配置持久化存储，支持外部高可用 MongoDB 和 MySQL：
注意
版本要求：MongoDB ≥ 4.4，MySQL ≥ 5.7
export IP=<IP>
export PORT=<合法端口>
export EMAIL=example@koderover.com
export PASSWORD=zadig
# 配置高可用 MySQL，需提前创建 dex 和 user 数据库
export MYSQL_HOST=<MYSQL_HOST>
export MYSQL_PORT=<MYSQL_PORT>
export MYSQL_USERNAME=<MYSQL_USERNAME>
export MYSQL_PASSWORD=<MYSQL_PASSWORD>
# 配置高可用 MongoDB
export MONGO_URI=<MONGO_URI>
export MONGO_DB=<MONGO_DB>
./install.sh
1
2
3
4
5
6
7
8
9
10
11
12
13
2
3
4
5
6
7
8
9
10
11
12
13
# 步骤 4：验证安装
安装约需 10 分钟，完成后可通过如下命令查看服务状态：
kubectl -n zadig get po
1
# 步骤 5：访问系统
安装输出中会显示访问地址。
提示
许可证获取与配置详见：许可证
# 升级
使用 Helm 命令升级，详见升级文档。
# 卸载
可通过脚本一键卸载 Zadig：
export NAMESPACE=zadig
curl -SsL https://github.com/koderover/zadig/releases/download/v3.4.1/uninstall.sh | bash
1
2
2
或使用官方最新版卸载脚本：
curl -SsL https://download.koderover.com/install?type=uninstall | bash
1
